home *** CD-ROM | disk | FTP | other *** search
/ JCSM Shareware Collection 1996 September / JCSM Shareware Collection (JCS Distribution) (September 1996).ISO / communic / commo65.zip / ADDENDUM.DOC < prev    next >
Text File  |  1995-07-15  |  11KB  |  342 lines
  1.  
  2.  
  3.  
  4.  
  5.                               {COMMO} 6.5 Addendum
  6.                               _____________________
  7.  
  8.      This Addendum contains the major additions and/or changes to the
  9.      {COMMO} 6.4x documentation.  Print out this file and keep it with your
  10.      printed manual.  There is a complete list of changes (major and minor)
  11.      in the file HISTORY.
  12.  
  13.  
  14.      ===============================
  15.      In the User Guide and Reference
  16.      ===============================
  17.  
  18.      Under "[Alt-G]  Edit Setup File"
  19.      --------------------------------
  20.  
  21.      ___________________________________________
  22.  
  23.      {esp=no}   Enhance serial priority (yes/no)
  24.      ___________________________________________
  25.  
  26.           Try setting this item to "yes" if your system drops characters
  27.           when TSR programs are installed (some of the symptoms are listed
  28.           under the "sld" item).  "esp" and "sld" may be tried in any
  29.           combination.
  30.  
  31.           NOTE:  This feature is automatically disabled when {COMMO}
  32.           detects DESQview, OS/2 or Windows (In DESQview set "Optimize
  33.           Communications" to "yes" for the same result).
  34.  
  35.           See also the "sld" item.
  36.  
  37.      _______________________________________________
  38.  
  39.      {set _exted}   Command line for external editor
  40.      _______________________________________________
  41.  
  42.           An external editor may be defined to edit the Dialing Directory
  43.           and Macro Files directly from their respective windows.  See
  44.           Appendix K for details.
  45.  
  46.  
  47.      Add under "Colors"
  48.      ------------------
  49.  
  50.      {kfs=70,1b,30}   File Selector window colors
  51.  
  52.  
  53.      -----=====  [Alt-U]  Utility Menu
  54.  
  55.      The Utility Menu is supported by a macro in COMMO.MAC.  It contains a
  56.      selection of features created by {COMMO} macros.
  57.  
  58.  
  59.  
  60.      Current features include:
  61.  
  62.           Add an entry to the Dialing Directory.
  63.           Set current terminal emulation.
  64.           Run the host mode macro, MOSTHOST.MAC.
  65.           Edit the host mode macro.
  66.           Edit any external text file less than 64k in size.
  67.           Run any macro by name (label).
  68.           Load any Macro File.
  69.           Modify certain setup items for the current session.
  70.  
  71.      NOTE:  The Utility Menu may not be available (or may have different
  72.      features on its menu) if an auxiliary Macro File has been loaded.
  73.  
  74.  
  75.      ==============================
  76.      In the Macro Programming Guide
  77.      ==============================
  78.  
  79.      New or Changed Function Descriptions
  80.      ------------------------------------
  81.  
  82.      Under ALARm, Switches
  83.      ---------------------
  84.  
  85.           F1 or F
  86.                Make the "failed" sound.
  87.  
  88.           F0
  89.                Make the "success" (ringing) sound (default).
  90.  
  91.  
  92.      ===  BEEP  ===
  93.  
  94.      Default key:   none
  95.      Description:   Play a sequence of sounds.
  96.  
  97.      Examples:
  98.  
  99.           {beep 36,440,18,523}
  100.                Play an A note for two seconds followed by a C note for one
  101.                second.
  102.  
  103.           {beep}
  104.                Default is a short beep sound.
  105.  
  106.      Listed arguments are treated as pairs.  The first number of each pair
  107.      is the duration of the sound in 18ths of a second (system clock
  108.      ticks).  The second number is the frequency in Hz (0 to 19 is
  109.      silence).
  110.  
  111.  
  112.  
  113.      Here is a frequency chart for five octaves:
  114.  
  115.           C         131     262     523     1040     2093
  116.           C#/Db     139     277     554     1103     2217
  117.           D         147     294     587     1176     2349
  118.           D#/Eb     156     311     622     1241     2489
  119.           E         165     330     659     1311     2637
  120.           F         175     349     698     1391     2794
  121.           F#/Gb     185     370     740     1488     2960
  122.           G         196     392     784     1568     3136
  123.           G#/Ab     208     415     831     1662     3322
  124.           A         220     440     880     1760     3520
  125.           A#/Bb     233     466     932     1866     3729
  126.           B         248     494     988     1973     3951
  127.  
  128.  
  129.      ===  FILE  ===
  130.  
  131.      Default key:   none
  132.      Description:   Find or display directory information.
  133.  
  134.      General form:
  135.  
  136.           {FILE path\filespec}
  137.  
  138.                path\filespec
  139.                     The path and filespec (file mask) to be used for
  140.                     finding or displaying directory entries (filenames and
  141.                     subdirectories).  The filespec may contain wildcards.
  142.  
  143.      Switches:
  144.  
  145.           X1 or X
  146.                Find next matching entry.
  147.  
  148.           X0
  149.                Find first matching entry (default).
  150.  
  151.           S1 or S
  152.                Display a listing of filenames and subdirectories.
  153.  
  154.      Examples:
  155.  
  156.           {file c:\upload\*.*}
  157.                Find first filename or subdirectory in the directory
  158.                "c:\upload."
  159.  
  160.           {file-x}
  161.                Find next filename or subdirectory.
  162.  
  163.           {file-s c:\upload\*.zip}
  164.                Display all subdirectories and .ZIP files in the directory
  165.                "c:\upload".
  166.  
  167.  
  168.  
  169.  
  170.      ----------  Using FILE to get file information: FILE, FILE-X
  171.  
  172.      The FILE function will find directory information about the files and
  173.      subdirectories specified in "filespec."  The data will be made
  174.      available in the following built-in variables:
  175.  
  176.           _ffn
  177.                Filename or subdirectory name.  Subdirectory names will be
  178.                preceded with a "\".  The parent directory is "\..".
  179.  
  180.           _ffs
  181.                File size in bytes.
  182.  
  183.           _ffd
  184.                File date.  The format will be as specified in Setup File
  185.                item "dat=".
  186.  
  187.           _fft
  188.                File time.  The format will be as specified in Setup File
  189.                item "tim=".
  190.  
  191.      The FILE function must be executed without the "X" switch (or with X0)
  192.      to initialize the directory.  This will also make available the first
  193.      filename or subdirectory.  Subsequent executions (with the "X" switch)
  194.      will make subsequent names available.
  195.  
  196.      Use the IFCOndition function to determine if a filename was made
  197.      available.  The first label ("true") will be taken if a filename was
  198.      found;  the second label ("false") will be taken if no additional
  199.      filenames are available.
  200.  
  201.      TIPS on using FILE, FILE-X:
  202.  
  203.       *   IMPORTANT!  Do not use IFEXist until all files have been found
  204.           (it uses the same DOS file finding functions).
  205.  
  206.       *   The built-in variables will always contain the data for the last
  207.           filename found.  If no filename has ever been found, the contents
  208.           are unpredictable.
  209.  
  210.  
  211.      ----------  Using FILE to Select files: FILE-S
  212.  
  213.      The "S" switch is used when you want {COMMO} to display the names of
  214.      the files in the specified directory.  Files may then be selected
  215.      (tagged) for uploading or other purposes.  Tagged pathnames are
  216.      appended to the file {SEND}.LST in the {COMMO} home directory (except
  217.      when Esc is pressed).  Facilities are also provided for navigating,
  218.      changing the filespec and editing the {SEND}.LST file.
  219.  
  220.      The Exit Code is set according to the user's action (keys are shown in
  221.      Online Help) and the built-in variable "_ffn" contains returned
  222.      information (when applicable).  The Exit Code appears in the variable
  223.  
  224.  
  225.  
  226.      "_err" and may also be tested with the IFERrorlevel function.  Exit
  227.      Codes are as follows:
  228.  
  229.           0    The "finish" key has been pressed.
  230.  
  231.           1    The Escape key has been pressed.
  232.  
  233.           2    The "edit" key has been pressed.
  234.  
  235.           3    A new drive has been chosen (drive letter is in "_ffn").
  236.  
  237.           4    A new directory has been chosen (subdirectory name is in
  238.                "_ffn" and is preceded by a "\";  the parent directory is
  239.                "\..").
  240.  
  241.           5    A new file specification has been entered (filespec is in
  242.                "_ffn", e.g., *.zip).
  243.  
  244.      TIPS on using FILE-S:
  245.  
  246.       *   Use {wind-k} to get a smooth display between invocations of
  247.           FILE-S.
  248.  
  249.       *   When a clean list is desired, {SEND}.LST should be deleted prior
  250.           to the first use of FILE-S.
  251.  
  252.  
  253.      Under GETString, Switches
  254.      -------------------------
  255.  
  256.           R1 or R
  257.                "Raw" mode.  A single character will be received and
  258.                converted to a decimal number string.  All 256 character
  259.                values are allowed. 
  260.  
  261.           R0
  262.                Normal GETString rules apply (default).
  263.  
  264.  
  265.      Under NOCArrier, Switches
  266.      -------------------------
  267.  
  268.           E or E1
  269.                Enable the "carrier lost" logic as if a connection had been
  270.                made using the Auto Dialer.  If no label is specified when
  271.                using the "E" switch, the current label will be retained.
  272.  
  273.           E0
  274.                Do not enable the "carrier lost" logic (default).
  275.  
  276.  
  277.  
  278.      Under SEND, Switches
  279.      --------------------
  280.  
  281.           B1 or B
  282.                Byte mode.  Characters are represented by decimal or hex
  283.                numbers, separated by commas.  Hex numbers are preceded by a
  284.                "0" and all characters from 0 to 255 may be sent.  There is
  285.                no conversion, no translation and no local echo.
  286.       
  287.           B0
  288.                Normal string mode (default).
  289.  
  290.  
  291.      =================
  292.      In the Appendices
  293.      =================
  294.  
  295.      Under "Appendix K  {COMMO} Support Files"
  296.      -----------------------------------------
  297.  
  298.      ----------  Using an External Editor
  299.  
  300.      (Note that this feature is unavailable during shareware evaluation.)
  301.  
  302.      An external text editor may be used to edit the Dialing Directory and
  303.      Macro Files directly from their respective windows.  Your editor's
  304.      command line is first defined in the reserved variable "_exted".  Then
  305.      you simply press Alt-E instead of "E" to use your editor instead of
  306.      the Internal Editor.
  307.  
  308.      TIPS on using an external editor:
  309.  
  310.       *   The file will be saved prior to running the editor (if changed),
  311.           and it will be reloaded upon return.
  312.  
  313.       *   Two built-in variables provide the filename and the line number
  314.           to be used on the editor's command line:
  315.  
  316.                _edf      The filename of the last file displayed (or
  317.                          current).
  318.  
  319.                _edl      The current line number of the cursor within the
  320.                          file.
  321.  
  322.           These may be used as in this Setup File example:
  323.  
  324.                {set _exted,c:\util\editor.exe %_hom%%_edf /n%_edl}
  325.  
  326.           NOTE:  The "_exted" variable may also be defined in a macro. 
  327.  
  328.       *   The command line is run as if it appeared in an {exec-DN...}
  329.           function -- i.e., direct, no clear and no swap.  This makes it as
  330.           fast and  seamless as possible.  If you need to use the DOS
  331.  
  332.  
  333.  
  334.           command processor (e.g., to run a batch file or to search the
  335.           path), define the command like this:
  336.  
  337.                {set _exted,c:\command.com /c editor %_hom%%_edf /n%_edl}
  338.  
  339.  
  340.                               - end -
  341.  
  342.